(C) 1996 AROS - The Amiga Replacement OS


NAME
#include <proto/dos.h>
BOOL Fault()
SYNOPSIS
LONG code
STRPTR header
STRPTR buffer
LONG len

LOCATION
In DOSBase at offset 78
FUNCTION
Fault will obtain the error message string for the given error code. First the header string is copied to the buffer, followed by a ":" (colon), then the NULL terminated string for the error message into the buffer.

By convention, error messages are ALWAYS less than 80 (plus 1 for NULL termination), and ideally less than 60 characters.

If the error code is not know, then the string "Unknown error" followed by the error number will be added to the string.

INPUTS
code
The error code.
header
The string to prepend to the buffer before the error text.
buffer
The destination buffer.
len
Length of the buffer.
RESULT
Number of characters placed in the buffer, may be 0.

NOTES
EXAMPLE
BUGS
SEE ALSO
INTERNALS
HISTORY
12.03.1997 iaint
Improved LONG to STRING conversion for unknown error
21.02.1997 iaint
Some support for localizing DOS
27.01.1997 ldp
Polish
09.12.1996 aros
Added empty templates for all missing functions

Moved #include's into first column